This document describes sample servers installed with the Producer.

Table of Contents
   ABOUT SAMPLE SERVERS
   USING SAMPLE SERVERS


ABOUT SAMPLE SERVERS
~~~~~~~~~~~~~~~~~~~~

The Helix Producer employs XML formatted text files to save all settings for a server destination.  These text files are called as server files.  The following sample server files are provided:

Single-password Push Server.rpsd
Multicast Push Server.rpsd
Legacy Push Server.rpsd
Account-based Push Server.rpsd
Pull (Server Initiated) Server.rpsd

Sample servers are provided as a starting point for creating a server definition.  Server definitions can be referenced from the command line using the -sd option (see command line help).  Following are instructions on how to run a sample job from the command line application.

USING SAMPLE SERVERS
~~~~~~~~~~~~~~~~~~~~
Sample servers may be used in one of two ways by the producer.
1. Copy server definition file to the 'servers' directory and reference by server name.
2. Reference server definition file directly by filename with extension.


The easiest way to use server definitions is to copy the definition to the servers directory.  The location of the servers directory is defined in the preferneces file (producer.pref) located in the application installation directory.  By default, the servers directory is located in the application root directory.

To add a new server definition for a Push server broadcast to the producer do the following:
1. Copy the server definition file 'Push-Account-based.rpsd' to the 'servers' directory in the application root.
2. Rename the file to "My Server.rpsd".  The name of the server definition is the name of the file without the file extension. In this case, the name is "My Server".  This is the name you will use when refernecing the file from command line or editing the file through the GUI.
3. Edit the contents of the file.  Server file are an XML file containing properties defined for a given server destination.  See the user documentation for more information on editing server files.
4. Now you are ready to reference the server from the command line application or GUI.  To refernece the server definition from the command line application you type the following:
   producer -i myfile.avi -sd "My Server,live.rm"
   Where "live.rm" is the name of the stream.  The username and password are read from the server definition file or they can be passed on the command line using the syntax 
   producer -i myfile.avi -sd "username:password@My Server,live.rm"
